package cn.chuan.keygen.module.verify.service.card;

import cn.chuan.keygen.module.verify.controller.app.card.vo.CardUpdateVO;
import jakarta.validation.*;
import cn.chuan.keygen.module.verify.controller.admin.card.vo.*;
import cn.chuan.keygen.module.verify.dal.dataobject.card.CardDO;
import cn.chuan.keygen.framework.common.pojo.PageResult;

/**
 * 充值卡 Service 接口
 *
 * @author chuan
 */
public interface CardService {

    /**
     * 创建充值卡
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createCard(@Valid CardSaveReqVO createReqVO);

    /**
     * 更新充值卡
     *
     * @param updateReqVO 更新信息
     */
    void bindCard(@Valid CardUpdateVO updateReqVO);


    /**
     * 更新充值卡
     *
     * @param updateReqVO 更新信息
     */
    void updateCard(@Valid CardSaveReqVO updateReqVO);

    /**
     * 删除充值卡
     *
     * @param id 编号
     */
    void deleteCard(Long id);

    /**
     * 获得充值卡
     *
     * @param id 编号
     * @return 充值卡
     */
    CardDO getCard(Long id);

    /**
     * 获得充值卡分页
     *
     * @param pageReqVO 分页查询
     * @return 充值卡分页
     */
    PageResult<CardDO> getCardPage(CardPageReqVO pageReqVO);

}